📦 Docs artifacts are ready: https://github.com/elixir-lang/ex_doc/actions/runs/15817040972/artifacts/3380425421

We may want to fix default ordering (displaying groups from :default_group_for_doc before Types,Functions,Callbacks) and update the docs before merging this.

Are you planning to send a PR for this too? :) You can also amend this one if you prefer!

Are you planning to send a PR for this too? :) You can also amend this one if you prefer!

If we have to fix it then yes I'll update this PR.

Yes, I should probably preserve it to avoid breaking changes, unless it would add a lot of complexity or complications. I am hoping it is rather just swapping operands somewhere :D

Yeah ok, it should not be that hard.

@josevalim Well it's actually already the case in version 0.37: "Functions" appear before groups from :default_group_for_docs. If I try to change that a test breaks.

So I'm just going to sort groups from :default_group_for_doc by name to keep the previous behaviour.

Yeah, without any default configuration, with 0.37.3 or 0.38.2 the following code:

  @doc group: "Z group last"
  def aaa, do: []

  @doc group: "A Group second"
  def zzz, do: []

  def mmm, do: []

...produces the following:

So I'd rather keep that behaviour and document it, as there is now a second simple way to control ordering!

(But I did make a change to sort those default groups by alphabetical order.)